Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 004 / handicap.arc / HANDICAP.DOC < prev next >

Wrap

Text File | 1985-08-04 | 37.3 KB | 887 lines

H A N D I C A P Version 1.3 A Program to Keep Track of Your Golf Scores and Your Golf Handicap Copyright 1985 Richard T. Wright All rights reserved You are encouraged to copy this program and its documentation and to share them with others on the following conditions: 1. No changes or alterations may be made to the program or its accompanying files (including this documentation). 2. No fee or other consideration may be charged for any copy. 3. Neither this notice nor those on the opening and second screens of the program may be changed or bypassed. Any comments, suggestions for improvements, or invitations to play golf will be appreciated and should be sent to: WRIGHT SOFTWARE ENTERPRISES P. O. Box 6488 Annapolis, Maryland 21401 IF YOU USE AND ENJOY THIS PROGRAM, RECEIPT OF YOUR $20.00 REGISTRATION CONTRIBUTION WILL BE VERY MUCH APPRECIATED. PLEASE MAKE THIS CONTRIBUTION AND DO YOUR PART TO ENCOURAGE USER-SUPPORTED SOFTWARE. TABLE OF CONTENTS BASIC PURPOSE . . . . . . . . . . . . . . . . . . . . . . . . 1 A FEW WORDS ABOUT TERMINOLOGY AND SPECIAL KEYS . . . . . . . . 1 DATA ENTRY INFORMATION . . . . . . . . . . . . . . . . . 1 "Enter" or "carriage return" . . . . . . . . . . . . 1 Letter key shown in parentheses . . . . . . . . . . 2 Backspace . . . . . . . . . . . . . . . . . . . . . 2 Escape . . . . . . . . . . . . . . . . . . . . . . . 2 Data entry fields . . . . . . . . . . . . . . . . . 2 GOLF HANDICAP TERMINOLOGY . . . . . . . . . . . . . . . . 2 Gross Score . . . . . . . . . . . . . . . . . . . . 2 Adjusted Score . . . . . . . . . . . . . . . . . . . 2 Differential . . . . . . . . . . . . . . . . . . . . 3 ABOUT THE HANDICAP PROGRAM . . . . . . . . . . . . . . . . . . 4 INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . 4 USING THE HANDICAP PROGRAM . . . . . . . . . . . . . . . . . . 6 Main Menu choice 1 . . . . . . . . . . . . . . . . . . . 6 Main Menu choice 2 . . . . . . . . . . . . . . . . . . . 6 Main Menu choice 3 . . . . . . . . . . . . . . . . . . . 6 Main Menu choice 4 . . . . . . . . . . . . . . . . . . . 6 Main Menu choice 5 . . . . . . . . . . . . . . . . . . . 6 Main Menu choice 6 . . . . . . . . . . . . . . . . . . . 7 Main Menu choice 7 . . . . . . . . . . . . . . . . . . . 7 ENTERING SYSTEM CUSTOMIZING INFORMATION . . . . . . . . . . . 7 ENTERING ROUND INFORMATION (MAIN MENU CHOICES 1 AND 2) . . . . 8 EDITING ROUND INFORMATION (MAIN MENU CHOICE 4) . . . . . . . . 9 LEARNING THE PROGRAM . . . . . . . . . . . . . . . . . . . . . 11 USER-SUPPORTED SOFTWARE . . . . . . . . . . . . . . . . . . . 11 REGISTRATION/ORDER FORM . . . . . . . . . . . . . . . . . . . 13 i BASIC PURPOSE: The basic purpose of HANDICAP is to make you a better golfer and to have more fun playing golf. The program keeps track of your golf scores and other information about the rounds of golf you play and calculates your handicap in accordance with United States Golf Association prescribed methods. (No sponsorship by the U.S.G.A is claimed by the author.) Hopefully, by observing scoring and play tendencies, you can figure out how to play better. At the very least, HANDICAP will give you a good argument for the appropriate number of strokes when comparing and adjusting your scores to those of your playing partners. HANDICAP allows you to prepare two reports to either your screen or printer: First, you can print out your current handicap and a list of all the rounds used in the calculation of that handicap. Rounds which comprise that actual basis of your handicap are specially designated. Second, the program will allow you to print selected rounds from those you have stored. You can select all your rounds, rounds for a certain course, rounds for any period, or rounds for a certain course during a certain period. After displaying the information you desire for this second type of report, the program calculates and displays the average gross score, adjusted score and differential for the rounds selected. If you have the Multi-Golfer Version of HANDICAP, the program allows you to print or display the above two reports for each golfer stored in the system and a third report which is a list of all golfers in the system and their respective handicaps. A FEW WORDS ABOUT TERMINOLOGY AND SPECIAL KEYS . . . Throughout the program and this documentation, certain keyboard keys and terms are repeatedly used which have special meanings: DATA ENTRY INFORMATION: You will often be asked to "ENTER" certain information. This means you should type in the information and press the "enter" or "carriage return" key when you are done. Pressing the carriage return key is necessary to complete the entry of any field (other than a date information field) which is longer than one character because the program has no other way of knowing when you are done entering information in that field. 1 Occasionally, the program may ask you to press the "C/R" key if you want to do something. "C/R" stands for carriage return or the "enter" key. All you have to do is press this key once to perform the indicated operation. Some portions of the program ask you to make a choice among several alternatives, such as "(Y)es or (N)o" and "(C)hange or (D)elete". To indicate your choice, you merely need to press the letter key shown in parentheses for the appropriate word. (For example, the "Y" key for "Yes", the "N" key for "No", the "C" key for "Change" and the "D" key for "Delete".) It doesn't matter whether or not you capitalize the key selected by pressing the shift key at the same time. HANDICAP will automatically convert all of such entries to upper case. Throughout the program, the backspace key and the escape key on your keyboard have special significance for correcting mistakes. The backspace key is "destructive". With the exception of date entry, if you mistype information or otherwise want to change your entry before you have pressed the carriage return key to indicate finality, you can backspace to the characters to be changed and then retype the information as you want it to be. Backspacing eliminates the characters which are erased on your screen. Alternatively, to erase everything entered on the line and start over, you merely need to press the escape key. If you are at the beginning of a line of information input and you press the escape key, the program will erase your prior entries on the screen and restart your input for the entire screen. Thus, if you are inputing information to the screen and you discover a mistake in a prior line which has already been "entered", you can restart information entry on the screen by pressing the escape key at the beginning of any information field. All data entry fields shown on the screen are marked by lines of periods, such as: Course: .................................. The periods indicate the permissible maximum length of the information to be put into the system. (Each period represents a permissible character input area.) If you exceed the length of the line of periods, the program will reject your entry, blank out the line, and ask you to restart. GOLF HANDICAP TERMINOLOGY: Your "Gross Score" for any round of golf is the actual round score as shown on your scorecard. Every stroke counts if it would count under the rules of the game. Your "Adjusted Score" is your gross score for the round adjusted by what the U.S.G.A. calls "Equitable Stroke Control". 2 Basically, "Equitable Stroke Control" is your protection against "sandbaggers". It works as follows: If you are a scratch (0 handicap) or plus (i.e. minus) handicap golfer, you are not allowed to count any stroke which is more than one over par for any given hole. If you are in this category, to calculate your adjusted score you would subtract one stroke from your gross score for each double bogey you scored, two strokes for each triple bogey, three strokes for each quadruple bogey, etc. If your handicap is between 1 and 18, you are allowed to count only as many double bogeys as equals your handicap. You are not allowed to count any stroke which is more than two over par for any given hole. Thus, if you were to have a handicap of 3 and you had a gross score for a round which included five double bogeys and a triple bogey (a thoroughly rotten day!), you would calculate your adjusted score for the round by subtracting one stroke each for the fourth and fifth double bogeys and two strokes for the triple. (Subtracting only one stroke for the triple would give you a fourth double bogey.) Your adjusted score would therefore be 4 less than your gross score. If your handicap is between 19 and 36, you are allowed to count all of your double bogeys but only as many triple bogeys as equals your handicap minus 18. You are not allowed to count any stroke which is more than three over par for any given hole. Thus, if you were to have a handicap of 21 and you had a gross score for a round which included five triple bogeys and a quadruple bogey, you would calculate your adjusted score for the round by subtracting one stroke each for the fourth and fifth triple bogeys and two strokes for the quadruple. (Again, subtracting only one stroke for the quadruple would give you a fourth triple bogey.) Your adjusted score would therefore be 4 less than your gross score. If your handicap is between 37 and 40, besides needing a lot of help beyond the scope of this program, you are allowed to count all of your double and triple bogeys but only as many quadruple bogeys as equals your handicap minus 36. You are not allowed to count any stroke which is more than four over par for any given hole. For obvious reasons, HANDICAP does not calculate your adjusted score automatically. You have to do it on your own. I find the best way to perform "Equitable Stroke Control" is to adjust my gross score on my scorecard right after counting up my gross score. The "Differential" for any round of golf is the difference between your "adjusted score" and the course rating for the course you played. U.S.G.A. handicaps are based on combined 3 differentials so golfers playing different courses can compare their games on a common basis. HANDICAP requires you to enter for each round the course rating for the course you played (the program will do this automatically if the course is the usual one you regularly play) and your adjusted score for the round. The program then automatically calculates and stores the differential for the round. Displaying or printing your rounds (i.e., all of them, those for a given period, those for a certain course, or those for a given course during a certain period) will also cause to be displayed or printed the average differential for the rounds selected. ABOUT THE HANDICAP PROGRAM Your distribution copy of HANDICAP should have the following files: HANDICAP.COM the basic HANDICAP program HANDICAP.DOC this documentation HCPINST.COM a screen installation program HCPINST.MSG which allows you to customize HCPINST.DTA HANDICAP to your particular screen Once you have run HANDICAP, additional files having the extension ".DTA" will be created. These files include HDEFAULT.DTA a data file which includes the customizing default information you enter for your program HANDICAP.DTA a data file which includes the names and handicaps of all golfers stored in the system plus various files named ********.DTA data files for each golfer stored in the system (the asterisks used above will be replaced by letter characters in your data files). INSTALLATION To install HANDICAP, you merely need to copy the files included with your distribution copy onto a disk (floppy or hard) formatted with your operating system. If you have an IBM PC or close compatible, you probably need to do nothing further to run the program other than to enter the 4 word "HANDICAP" after you boot up and see your DOS prompt (e.g., "A>" or "C>") displayed. If you don't have a close IBM PC compatible, before you use HANDICAP, it must be installed to your particular terminal, i.e. provided with information regarding control characters required for certain functions. This installation is easily performed using the program HCPINSTALL which is described in the following: After having made a work-copy, store your distribution diskette safely away and work only on the copy. Start the installation by typing "HCPINSTALL" at your terminal. Next, select Screen installation from the main menu. If you use HANDICAP without installation, the default screen set-up will be used. You may override this default by selecting another screen mode from this menu: ----------------------------------------------------------------- Choose one of the following displays: 0) Default display mode 1) Monochrome display 2) Color display 80x25 3) Color display 40x25 4) b/w display 80x25 5) b/w display 40x25 Which display (enter no. or ^X to exit) ----------------------------------------------------------------- Each time HANDICAP runs, the selected mode will be used, and you will return to the default mode on exit. 5 USING THE HANDICAP PROGRAM HANDICAP is completely menu driven. When you run HANDICAP, after proceeding through the opening screen(s), you are presented with the following Main Menu screen: -------------------------------------------------------------- PROGRAM ACTIVITIES: 1 - ADD NEW ROUND INFORMATION AND CALCULATE NEW HANDICAP 2 - ADD NEW ROUND INFORMATION (NO NEW HANDICAP CALCULATION) 3 - RECALCULATE HANDICAP USING ROUNDS ALREADY IN SYSTEM 4 - SEE, CHANGE, OR DELETE ROUND INFORMATION 5 - PREPARE REPORTS 6 - SYSTEM CHANGES 7 - EXIT FROM PROGRAM TO DOS WHAT IS YOUR CHOICE? (1, 2, 3, 4, 5, 6, or 7) . -------------------------------------------------------------- The Main Menu lists all of the activities carried on by the program. The user merely selects the number appropriate to the task he or she wants performed. (If the user is using the Multi-Golfer Version of HANDICAP, he will next be prompted to indicate the first and last names of the particular golfer for which he wants the menu task performed.) Normally, the user will want to input one or more rounds into the system and to have his updated handicap displayed after doing so. Menu choice 1 accomplishes this task. Alternatively, the user can use menu choice 2 to input one or more rounds into the system without a new handicap calculation. Menu choice 3 can be used to display a handicap based on existing rounds stored in the system at any time (such as after rounds are input without new handicap display or after rounds put in out of order are resorted as discussed below). If you ever want to see what information you've entered for a given round, change that information, or delete the information, choose menu option 4. Menu option 5 allows you to print to the screen or your printer the reports generated by the program. 6 Menu choice 6 allows you to do one of two things: First, you can enter or change default information which customizes your HANDICAP copy to you. HANDICAP invokes this choice automatically the first time you attempt to enter a round into the system. Thereafter, this customizing information can be changed by first electing Main Menu choice 6 and then selecting choice A on the System Changes Menu. Alternatively, should you enter rounds out of order, choice B on the System Changes menu will resort the rounds in your system by date. (If two rounds have the same date, the first round entered will be considered as having been played first.) (The Multi-Golfer Version of HANDICAP also includes a C option on the System Changes menu which allows you to delete a golfer from your system.) Menu choice 7 obviously ends the program and returns you to your operating system prompt. ENTERING SYSTEM CUSTOMIZING INFORMATION When you first use HANDICAP or when you select Main Menu choice 6 and then the A choice on the System Changes Menu, the program takes you through a series of questions designed to obtain information to customize HANDICAP to your particular needs: First, you are asked to enter the default golfer's first name. The default golfer is the user in the distribution version of HANDICAP and the golfer who most often uses the system in the Multi-Golfer Version. After entering the default golfer's first name, you are next prompted to enter that golfer's last name. Each of these entries may be up to 15 characters long. You are next prompted to enter the name of the "default golf course". This entry is the golf course for which rounds are most likely to be entered and can be up to 35 characters long. After this, HANDICAP prompts you to enter a four digit (including the decimal point) entry to indicate the most commonly used course rating for the default golf course. Storing this information allows the input of these items when entering round information with a single keystroke. (After entering the default golf course rating, the Multi-Golfer Version of HANDICAP asks you if you want to operate in a single golfer or a multi-golfer mode. Choice of the single golfer mode simplifies usage when only one golfer is using the system until the choice is changed by a subsequent reinput of the customizing data input. If you choose to operate in the Multi-Golfer mode, the Multi-Golfer Version then asks you to indicate on which drive (A, B, or C) your data (".DTA") files will be kept. Multi-Golfer Version data file storage is limited only 7 by the storage limits of the storage medium chosen. Numerous golfers can be accommodated on several floppy disks if necessary.) After responding to all of the customizing information inquiries, the program prompts you to look over what you have entered and to make sure that the information typed in is appropriate. At this point, press the "Y" key if everything looks satisfactory and the "N" key if you find a mistake and want to restart from the beginning. ENTERING ROUND INFORMATION (MAIN MENU CHOICES 1 AND 2) When you select Main Menu choices 1 or 2, HANDICAP displays the following screen: ----------------------------------------------------------------- GOLFER: ********************** CURRENT HANDICAP: ** Round Number: . Date (MM/DD/YY): ........ Course ................................... Course Rating: .... Gross Score: ... Adjusted Score: ... Comments: ................................... ----------------------------------------------------------------- The current golfer's name is displayed so you can make sure that your information will be stored for the appropriate golfer. The handicap for that golfer is displayed as an aid in calculating any adjustments to the Gross Score (according to U.S.G.A. Equitable Stroke Control requirements) to establish the golfer's Adjusted Score. Once the input screen has been displayed, HANDICAP automatically supplies the Round Number for you and displays this number in the appropriate blank. The first blank you are prompted to complete is that for the date of the round you wish to enter. Because the date field information is used to sort rounds into proper order, date entry in HANDICAP is somewhat structured. You must enter date information in the indicated month/date/year format. Single digit entries must be preceded by a zero. Slashes are supplied automatically for you. To save keystrokes, the first digit of the 8 year ("8") is also always supplied for you. You only need to press the appropriate keys for the month number, date number and final digit of the appropriate year. You do not have to press the carriage return key when you are done entering the date. HANDICAP knows when you are done by the number of keystrokes pressed. After pressing the appropriate keys for the date, you are next prompted to enter the name of the course played during the round. If the course is the default golf course entered for the system, you merely need to respond to this prompt by pressing the carriage return key and the course name and rating are automatically supplied. If a course other than the default golf course was played, enter the name of the course (up to 35 characters) and then the course rating (up to 4 characters including the decimal indicator). You are next prompted to enter the Gross Score and the Adjusted Score for the round. Calculate the golfer's adjusted score as discussed above using Equitable Stroke Control. If the Adjusted Score is the same as the Gross Score, you need merely press the carriage return key at the appropriate line and the adjusted score will be automatically displayed. Finally, you are prompted to input any comments you may care to save to better remember the round or other information about it. You are not required to enter any comments and may merely press the carriage return key to bypass this field. After proceeding through all of these input prompts, HANDICAP asks you to make sure that the information you have typed is correct. Read over your entries to make sure that they say want you want. Press the "Y" key if you are satisfied or the "N" if you want to start over to correct an error. (If you see a mistake, you can still press the "Y" key to record the round and then edit it using Main Menu choice 4.) Once you have responded that you are satisfied with the information entered, HANDICAP stores the round information to a disk file and asks you if you want to input another round. If so, the program restarts the round information input screen process. If not, HANDICAP either recalculates and displays the golfer's handicap (Main Menu choice 1) or returns you to the Main Menu (Main Menu choice 2). EDITING ROUND INFORMATION (MAIN MENU CHOICE 4) If you have entered round information and subsequently want to see it, change it, or delete the round altogether, select Main Menu choice 4. 9 When this procedure is selected, a round input screen comparable to that shown above is displayed and you are prompted to select a round either by Round Number or by Date. HANDICAP then searches for the round meeting the indicated criteria and either displays this round to the screen or indicates that such a round can't be found. If the round displayed is not that which you wanted, respond the to question "IS THIS THE ROUND YOU WISHED TO CHOOSE?" with an "N" and you will restart the round selection process. Once the round you wished to see, change or delete is displayed and you have confirmed your selection, HANDICAP asks you if you want to "(C)hange" or "(D)elete" the information displayed. If you want to delete the displayed round, answer the change or delete inquiry with a "Y" and then press the "D" key to confirm the deletion. The round information will then be irrevocably erased from the system. If you want to change any of the round information displayed, answer the change or delete inquiry with a "Y" and then press the "C" key. Each of the changeable fields will then be shown with a capital letter (A through F). To change information in a field, press the key for the letter associated with that field and then merely reenter the information on the indicated line as you want it to be stored. After completing the data reentry, respond to the "ARE YOU SURE . . ." inquiry with a "Y". After you've changed the information for one field in a round, HANDICAP asks you if you want to change the information in any other field. If you answer with a "Y", repeat the process described above for the chosen field. Once you enter a "N" here, the edited information is stored to disk in place of the old round information, and the program will ask you if you want to see, change or delete any other rounds. Once you respond to this inquiry with a "N", you are returned to the Main Menu. PLEASE NOTE THE FOLLOWING ABOUT EDITED ROUNDS: If you change the Date for a stored round, you will have to resort your rounds using Main Menu choice 6 and System Changes Menu choice B to put your rounds in proper order for handicap calculation. If you delete a round, you do not have to resort your rounds. The deleted round is erase from the system and all remaining rounds in the system are automatically renumbered. If you start to change the information in any round field and then change your mind (or if you press the wrong field designation letter key), you can "escape" the change at any time 10 before pressing the carriage return key ending the edit of the field in question. Pressing the escape key after entering one or more characters will restart data entry in the designated field and place the cursor under the first character. Pressing the escape key again will stop the edit for that field and redisplay the information previously entered. LEARNING THE PROGRAM . . . Use of HANDICAP doesn't really need much more description. (It probably doesn't need as much as is included above.) Throughout the program you are almost always prompted with the range of permissible responses, and, if you make a mistake, HANDICAP will let you know and then restart you at the point where the mistake was made. If you want to try to learn the program on a trial basis before entering true-to-life information, make up a fictitious golfer name, etc. (e.g., George Sample), enter information for him when you customize the system information, and then enter some fictitious rounds. (I would enter at least five rounds so you can obtain a handicap calculation.) Print or display both the A and B reports for your fictitious rounds until you become comfortable with the system. When you're comfortable, reenter the System Changes Menu from the Main Menu (choice 6) and then recustomize your system to yourself. USER-SUPPORTED SOFTWARE (A COMMERCIAL FOR MYSELF) If you've obtained a copy of HANDICAP, you are probably familiar with the concept of user-supported software. Free distribution of software and voluntary payment for its use eliminates the need for bothersome copy protection schemes and reduces the price of software by eliminating advertising and marketing costs. Users get to try out software at a relaxed pace and setting. Good programs are rewarded based solely on their quality and utility. I've tried to make HANDICAP as "commercial" in appearance and as easy to use as possible. After all, we'd all rather be playing golf than learning new software. (If you have any suggestions for improvements, I'd appreciate hearing them.) As my wife can attest, development of this program took an awful lot of time and effort. Like anyone else, I'd like to be compensated for that time and effort. If you like my program and find it to be of use, I'd appreciate receiving a registration contribution of $20.00. If you like the program, I think the price is a fair one. 11 As I've indicated above, a Multi-Golfer Version of HANDICAP is available for purchase. To obtain the Multi-Golfer Version, you must be a registered owner of the distribution (single user) version. The Multi-Golfer Version is available for $35.00 (over and above the $20.00 initial registration contribution). To order the Multi-Golfer Version, complete the following order form and send me a MS-DOS or PC-DOS formatted five and a quarter inch floppy diskette and your check in the appropriate amount. Thanks for using and supporting HANDICAP. Richard T. Wright Wright Software Enterprises P. O. Box 6488 Annapolis, Maryland 21401 12 ********************* REGISTRATION/ORDER FORM ******************** (Please print or type) TO: WRIGHT SOFTWARE ENTERPRISES P. O. BOX 6488 ANNAPOLIS, MARYLAND 21401 FROM: ____________________________________________ ____________________________________________ ____________________________________________ ____________________________________________ Telephone: (_____) _________________________ Check the appropriate blank: ( ) Please register me as a user of HANDICAP. My $20.00 registration contribution is enclosed. ( ) Please send me a copy of the Multi-Golfer Version of HANDICAP. I have enclosed a MS-DOS or PC-DOS formatted five and a quarter inch disk and $35.00 (over and above the registration contribution) for the price of this version of the program. Total amount enclosed: $ _______________ Comments about HANDICAP and/or suggestions for improvement: ***************************************************************** 13